home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Mac Game Programming Gurus / TricksOfTheMacGameProgrammingGurus.iso / More Source / C⁄C++ / Infinity Windoid 3.0 / About Infinity Windoid next >
Text File  |  1995-02-20  |  5KB  |  79 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12. INFINITY WINDOID 3.0
  13.  
  14. Written by Troy Gaul
  15. © 1991-95 Infinity Systems
  16. All rights reserved.
  17.  
  18.  
  19. DESCRIPTION:
  20. This archive contains the source for a standalone code resource that conforms to a Window DEFinition (WDEF), as defined by Apple Computer in Inside Macintosh.
  21.         
  22. It provides a 'windoid' appearance. A windoid is a floating window that appears above document windows in an application and is commonly used for things like tool palettes, information windows, and the like.
  23.  
  24. The versions of the Windoid WDEF included in the ResEdit files can be used as-is. This WDEF is created for System 6 and later, but it would be easy to modify it for earlier systems if this is important.
  25.  
  26. There are compiler flags available in the code to support the ways in which the THINK languages and MacApp handle their own windoid WDEFs. (These are also included in the Other Styles folder in this archive, so you can just copy them to use in place of the original. Note that the MacApp Style Windoid does not support ALL of the possible variations, but it supports the most common ones (is supports everything except the "large" titlebar with title, and the grow box options).
  27.  
  28. I would like to see this WDEF be used as widely as possible, as I have seen many programs recently that use the old-style black-and-white version. The WDEF should be fairly compatible with the ones included with THINK Pascal and MacApp among others, so it should require a minimum of work to use. Also, I plan to support and upgrade this WDEF as needed, while maintaining its freeware status and including the source code (so it can be modified). I only request any modification of this WDEF be true to its form in terms of graphical design, and that you inform me of any changes (possibly providing source code if you think it might be useful to other Infinity Windoid users).
  29.  
  30.  
  31. FEATURES:
  32. •  Supports System 7-style coloring of windows.
  33. •  In System 7, the tinge color set by the user in the Color control panel is used.
  34. •  Close box can be enabled from NewWindow by setting goAwayFlag.
  35. •  Zoom box implemented, utilized by adding 4 to the proc ID used to create the windoid.
  36. •  Title bar can appear along the left of the window if 8 is added to the proc ID.
  37. •  For MacApp users, the behavior of the windoid can be switched.
  38. •  DeviceLoop is used so the windoid will be drawn correctly even when it crosses monitors of differing depths.
  39. •  In System 7, indexed monitors' color tables are checked to see if there are enough different colors to display the color version (like the system WDEF).
  40. •    Supports title string in the titlebar.
  41. •    Supports a grow box (add 2 to the procID).
  42. •    Provides a choice between styles of the titlebar (normal or one that looks like the System 7.5 floating window WDEF).
  43.     
  44.  
  45. CHANGES IN VERSION 3.0:
  46. • Added a new variation that makes the Infinity Windoid act exactly like the System 7.5 floating window WDEF.
  47. • Changed the address information (both e-mail and US mail) to reflect my new location.
  48. • Added project file for Metrowerks CodeWarrior for PowerPC (also, updated Symantec project file to version 7.0.x).
  49. • Made the WDEF use NewHandleClear instead of NewHandle so that the Rects for zooming would be zeroed like the System WDEF's are when there is no zoom box.
  50. • Now requires Universal Headers.
  51. • When compiling for PowerPC, the drawing routines no longer allocate a small amount of temporary memory in the heap each time they are called.
  52. • Made zoom box behavior more consistent with the standard System WDEF.
  53. • A few compiler options have been removed to simplify the code.
  54. • Reorganized drawing code.
  55.  
  56. For a full history of changes made in this and previous versions, see the enclosed file "Version History" in the Documentation folder.
  57.  
  58.  
  59. WDEF TESTER:
  60. A WDEF Tester application is also included. This application is not yet in final form (and may never be).  Notably, it does not work with System 6 or 68000 Macs yet. Note, however, that the Infinity Windoid WILL work on such systems. The tester does not yet have a documentation file, but its features should be pretty self-explanatory. In order to try out the Infinity Windoid file included with this archive, simply drop it onto the WDEF Tester application. You will then be prompted for paramaters (the WDEF in the file you dropped will be the default). Note also that the default build of the WDEF doesn't include support for a grow box or a title in the titlebar. There are other versions with other features in the Other Versions folder.
  61.  
  62.  
  63. LEGAL STUFF:
  64. Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appears in all copies (of the source). This software is provided "as is" without express or implied warranty. 
  65.  
  66. It cannot be distributed for profit, but it may be included in packages of freeware for which a nominal fee is being charged as long as there is a special offer for authors of the software included in the package.
  67.  
  68.  
  69. HOW TO CONTACT THE AUTHOR:
  70. To register your copy of this WDEF if you plan to use it and want updates in the future, send me your e-mail address(es). Also, use these addresses to contact me with any problems or suggestions.
  71.  
  72. Troy Gaul
  73. Infinity Systems
  74.  
  75. Internet:              tgaul@halcyon.com (preferred)
  76. America Online:   TGaul
  77. eWorld:                TGaul
  78. U.S. Mail:              8500 148th Ave. N.E. #CC1101
  79.                             Redmond, Washington 98052